home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
sat_intrp_pathname.z
/
sat_intrp_pathname
Wrap
Text File
|
1998-10-20
|
7KB
|
133 lines
SSSSAAAATTTT____IIIINNNNTTTTRRRRPPPP____PPPPAAAATTTTHHHHNNNNAAAAMMMMEEEE((((3333)))) SSSSAAAATTTT____IIIINNNNTTTTRRRRPPPP____PPPPAAAATTTTHHHHNNNNAAAAMMMMEEEE((((3333))))
NNNNAAAAMMMMEEEE
ssssaaaatttt____iiiinnnnttttrrrrpppp____ppppaaaatttthhhhnnnnaaaammmmeeee - Portable interface to interpret sat_pathname
structs.
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ssssaaaatttt....hhhh>>>>
iiiinnnntttt ssssaaaatttt____iiiinnnnttttrrrrpppp____ppppaaaatttthhhhnnnnaaaammmmeeee ((((cccchhhhaaaarrrr ********bbbbuuuuffff,,,, ssssttttrrrruuuucccctttt ssssaaaatttt____ppppaaaatttthhhhnnnnaaaammmmeeee ****ppppnnnn,,,, cccchhhhaaaarrrr
********rrrreeeeqqqqnnnnaaaammmmeeee,,,, cccchhhhaaaarrrr ********aaaaccccttttnnnnaaaammmmeeee,,,, mmmmaaaacccc____llllaaaabbbbeeeellll ********llllaaaabbbbeeeellll,,,, iiiinnnntttt ffffiiiilllleeee____mmmmaaaajjjjoooorrrr,,,, iiiinnnntttt
ffffiiiilllleeee____mmmmiiiinnnnoooorrrr))));;;;
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
ssssaaaatttt____iiiinnnnttttrrrrpppp____ppppaaaatttthhhhnnnnaaaammmmeeee takes a pointer to a buffer (_b_u_f) containing the disk
image of a ssssaaaatttt____ppppaaaatttthhhhnnnnaaaammmmeeee structure. It unpacks the variable length
portions of the struct from _b_u_f and returns them in the specified
arguments. A pointer to the data following the pathname information is
returned in _b_u_f.
The ssssaaaatttt____ppppaaaatttthhhhnnnnaaaammmmeeee structure includes the following fields:
iiiinnnnoooo____tttt ssssaaaatttt____iiiinnnnooooddddeeee;;;; ////**** iiiinnnnooooddddeeee nnnnuuuummmmbbbbeeeerrrr ooooffff ffffiiiilllleeee ****////
ddddeeeevvvv____tttt ssssaaaatttt____ddddeeeevvvviiiicccceeee;;;; ////**** ddddeeeevvvviiiicccceeee nnnnoooo.... ooooffff mmmmoooouuuunnnntttteeeedddd ffffiiiilllleeee ssssyyyysssstttteeeemmmm ****////
uuuuiiiidddd____tttt ssssaaaatttt____ffffiiiilllleeeeoooowwwwnnnn;;;; ////**** ffffiiiilllleeee oooowwwwnnnneeeerrrr ****////
ggggiiiidddd____tttt ssssaaaatttt____ffffiiiilllleeeeggggrrrrpppp;;;; ////**** ffffiiiilllleeee ggggrrrroooouuuupppp ****////
mmmmooooddddeeee____tttt ssssaaaatttt____ffffiiiilllleeeemmmmooooddddeeee;;;; ////**** ffffiiiilllleeee mmmmooooddddeeee,,,, iiiinnnncccclllluuuuddddiiiinnnngggg ffffiiiilllleeee ttttyyyyppppeeee ****////
Additional data is appended to the struct in the disk format. This
informtaion is returned in the arguments as follows:
_r_e_q_n_a_m_e The pathname that the system call specified
_a_c_t_n_a_m_e The pathname that the the system actually looked up,
including crossed mount points, symbolic links, and
multi-level directories.
_l_a_b_e_l The security label of the file. It is preferred, but not
required, to only specify this field if ssssaaaatttt____mmmmaaaacccc____eeeennnnaaaabbbblllleeeedddd is
set in the file header.
If any of these fields are NULL, the related information will not be
returned. If these fields are non-null (i.e. they represent the address
of a suitable pointer), sufficient storage will be allocated to hold the
values. These fields should be freed (see ffffrrrreeeeeeee(3)) when they are no
longer needed.
The file label is only available if ssssaaaatttt____mmmmaaaacccc____eeeennnnaaaabbbblllleeeedddd is set in the file
header, otherwise this field will be NULL. To avoid possible problems if
trailing data happens to resemble a mmmmaaaacccc____llllaaaabbbbeeeellll, do not ask for the file
label unless ssssaaaatttt____mmmmaaaacccc____eeeennnnaaaabbbblllleeeedddd is set in the file header.
PPPPaaaaggggeeee 1111
SSSSAAAATTTT____IIIINNNNTTTTRRRRPPPP____PPPPAAAATTTTHHHHNNNNAAAAMMMMEEEE((((3333)))) SSSSAAAATTTT____IIIINNNNTTTTRRRRPPPP____PPPPAAAATTTTHHHHNNNNAAAAMMMMEEEE((((3333))))
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
ssssaaaatttt____rrrreeeeaaaadddd____hhhheeeeaaaaddddeeeerrrr____iiiinnnnffffoooo returns 0 on success or -1 if the ssssaaaatttt____ppppaaaatttthhhhnnnnaaaammmmeeee
struct is not valid. In this case, an error message is displayed on
stderr.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
ffffrrrreeeeeeee(3C), ssssaaaatttt____rrrreeeeaaaadddd____ffffiiiilllleeee____iiiinnnnffffoooo(3), ssssaaaatttt____rrrreeeeaaaadddd____hhhheeeeaaaaddddeeeerrrr____iiiinnnnffffoooo(3).
PPPPaaaaggggeeee 2222